云函数HTTP POST请求

简要描述

• 云函数发起HTTP POST请求，URL的host必须在当前应用白名单内

方法名称

• httpPost

调用参数

参数名	必选	类型	说明
url	是	string	请求地址，域名必须在白名单内
body	否	string/object	请求体，可以是字符串或对象（自动转为JSON）

调用实例

// 调用方法 - body为对象
var res = potato.httpPost("https://api.example.com/data", {name: "test", value: 123})
// 返回给调用接口
res

// 调用方法 - body为字符串
var res = potato.httpPost("https://api.example.com/data", "{\"name\":\"test\"}")
// 返回给调用接口
res

调用方法返回示例

{"code":200,"data":"success"}

返回参数

参数名	必选	类型	说明
response	是	string	响应内容字符串

API调用参数

参数名	必选	类型	说明
name	是	string	函数名称
params	否	json	调用参数

API调用实例

{
	"name":"testFun"
}

API调用请求头

参数名	必选	类型	说明
Content-Type	是	string	此参数必传，当请求数据非json时此参数传对应格式如（multipartform-data，application/x-www-form-urlencoded，等）是json请传application/json
askKey	是	string	此参数必传,验证app的令牌
sign	否	string	此参数如果在app设置开启了验签是必传
time	否	string	当开启验签时，此参数为必传
apiUserToken	否	string	用户令牌
nonce	否	string	随机字符串(当开启V3验签此参数必传，且6分钟内不允许重复)

API调用返回参数说明

参数名	类型	说明
code	string	状态码200成功,403权限异常或登录超时,500请求异常,203请求无数据
status	int	状态0删除1使用
data	object	返回内容，云函数如果没有返回结果则该值为空
res	object	执行返回数据
param	object	返回执行参数,可以忽略
nonce	string	随机字符串(当开启V3验签必返回次参数，且6分钟内不会重复)
sign	string	此参数如果在app设置开启了验签是必返
reqSign	string	请求签名
time	long	当开启验签时，此参数为必返回

API调用返回示例

{
	"code": "200",
	"message": "",
	"status": true,
	"data": {
		"res": "{\"code\":200,\"data\":\"success\"}"
	},
	"pc": null,
	"time": null,
	"nonce": null,
	"sign": null,
	"reqSign": null
}

备注

• URL的域名必须在应用白名单中配置
• body为对象时会自动转为JSON字符串
• 请求超时或网络异常时会抛出异常
• 返回的是字符串，需要自行解析JSON
• 更多返回错误代码请查看 错误代码参考